Add Xcode installation guide for Codex and Claude Agent#2431
Merged
SamMorrowDrums merged 2 commits intomainfrom May 6, 2026
Merged
Add Xcode installation guide for Codex and Claude Agent#2431SamMorrowDrums merged 2 commits intomainfrom
SamMorrowDrums merged 2 commits intomainfrom
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
Adds documentation for configuring the GitHub MCP Server inside Xcode’s built-in coding agents, so users can follow a clear, Xcode-specific setup path rather than relying on global CLI/desktop configuration locations.
Changes:
- Added a new Xcode installation guide describing agent-specific configuration directories and PATH caveats.
- Updated the installation-guides index to include the Xcode guide and list Xcode (Codex) / Xcode (Claude Agent) in the support table.
Show a summary per file
| File | Description |
|---|---|
| docs/installation-guides/README.md | Adds the Xcode guide to the list and adds Xcode (Codex/Claude Agent) rows to the support matrix. |
| docs/installation-guides/install-xcode.md | New guide documenting Xcode-specific config directories, setup links, PATH notes, and troubleshooting. |
Copilot's findings
Comments suppressed due to low confidence (1)
docs/installation-guides/install-xcode.md:34
- The troubleshooting guidance references
~/.claude.json, but the existing Claude guide documents different default locations (e.g.,~/Library/Application Support/Claude/claude_desktop_config.jsonon macOS). To prevent confusion, update this to reference the same defaults described in install-claude.md (or the correct global path for the specific Claude Agent you mean).
| Tools not loading | Config placed in wrong directory | Ensure config is in the Xcode-specific path above, not `~/.codex/` or `~/.claude.json` |
- Files reviewed: 2/2 changed files
- Comments generated: 3
SamMorrowDrums
approved these changes
May 6, 2026
Collaborator
SamMorrowDrums
left a comment
SamMorrowDrums
left a comment
There was a problem hiding this comment.
Thanks @RossTarrant
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a new
install-xcode.mdinstallation guide covering how to add the GitHub MCP server to Xcode's built-in coding agents (Codex and Claude Agent).Why
There was no documentation for adding the GitHub MCP server to Xcode's native coding agents, making setup unclear for users. This addresses the request raised in #2120.
Fixes #2120
What changed
docs/installation-guides/install-xcode.md— a focused guide explaining Xcode's agent-specific config directories, linking to existinginstall-codex.mdandinstall-claude.mdfor setup steps, and noting the macOS PATH requirement for local STDIO serversdocs/installation-guides/README.md— addedinstall-xcode.mdto the guides list and updated the support table to show both Xcode (Codex) and Xcode (Claude Agent) with local and remote supportMCP impact
Prompts tested (tool changes only)
Security / limits
Tool renaming
Lint & tests
./script/lint./script/testDocs